Exemple 7 : Mettre à jour des enregistrements

Dans cet exemple, l'outil Importer est utilisé pour mettre à jour les enregistrements dans EMu. La mise à jour des enregistrements nécessite qu'un champ unique (ou une combinaison de champs uniques) soit utilisé pour identifier un enregistrement existant. En d’autres termes, si un champ unique (ou une combinaison de champs uniques) est présent dans le fichier Importation des données et qu'il existe un enregistrement correspondant, ce dernier sera mis à jour au lieu de créer un nouvel enregistrement.

L'unicité est déterminée par une combinaison de deux conditions. Les deux doivent être remplies :

1. Le champ doit être spécifié comme unique dans le back-end.

   Chaque module comporte au moins un champ qui est spécifié comme unique dans le back-end par défaut : NEI.

   L'attribut Unique peut être défini en utilisant l'entrée de Registre Unique Index Indexing.

2. L'entrée de Registre Unique Strict doit être spécifiée pour chacun de ces champs uniques (sauf pour NEI).

   Unique Strict indique si l'unicité d'un champ doit être vérifiée lors du traitement d'un nouvel enregistrement ou de la modification d'un enregistrement existant. En général, la vérification se fait en quittant un champ (avec affichage d'un avertissement s'il s'agit d'un doublon), mais dans le cas de l'outil Importer, elle se fait après le traitement de chaque enregistrement.

   Note: Pour les valeurs uniques multi-colonnes (où une combinaison de champs est utilisée pour spécifier l'unicité), il est nécessaire de définir Unique dans le back-end et de spécifier Unique Strict dans le Registre pour chacun des champs.

Cet exemple utilise le Numéro d'enregistrement interne ainsi que le Numéro d'accession pour identifier les enregistrements dans le module Catalogue et mettre à jour les champs Constat d'état de l'enregistrement localisé : si des champs uniques sont spécifiés dans le fichier de données et qu'un enregistrement correspondant est identifié dans EMu, l'enregistrement d' est mis à jour.

Notez que si un enregistrement avec un champ unique spécifié dans le fichier de données n'existe pas dans EMu, il sera créé.

Note: Dans cet exemple, les mises à jour ne fonctionneront que si le Numéro d'accession a été réglé comme champ Unique dans le Catalogue.

Note: Les champs Uniques ne peuvent pas être mis à jour eux-mêmes.

Règles

1. Si un seul enregistrement dans le fichier de données correspond à un enregistrement dans EMu utilisant un ou des champs configurés dans EMu pour être uniques (par exemple un Numéro d'enregistrement interne), l'enregistrement est mis à jour.
2. Si un Nom de colonne est inclus dans le fichier Importation des données, mais qu'aucune valeur ne lui est associée, toute valeur existante dans le champ sera supprimée de l'enregistrement EMu correspondant lors de l'importation.

   Cela peut être utile si vous souhaitez effacer toutes les valeurs existantes d'un champ particulier. Cependant, cela peut être potentiellement dangereux car vous pourriez effacer toutes les valeurs d’un champ par inadvertance.

3. Si un enregistrement du fichier Importation des données inclut un champ configuré pour être unique dans EMu (par exemple un NEI) et qu'il n'y a pas d'enregistrement correspondant, un nouvel enregistrement est créé.
4. Si un enregistrement dans le fichier Importation des données inclut un champ configuré pour être unique dans EMu (par exemple un NEI) et qu'il y a plus d'une correspondance, une erreur est générée.
5. Les champs Uniques ne peuvent pas être mis à jour eux-mêmes.

Dans cet exemple les champs sont :

Champs	Nom back-end
NEI	irn
Numéro d'accession	TitAccessionNo
État de l'objet	ConConditionStatus
Date du constat	ConDateChecked
Vérificateur	ConCheckedByRef
Détails de l'état de l'objet	ConConditionDetails